Linux Cubed Series 3: Developer Tools

home *** CD-ROM | disk | FTP | other *** search

/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / devel / lang / ada / readme < prev next >

Wrap

Text File | 1996-11-16 | 23.7 KB | 563 lines

Subject: GNAT README Last Updated July 14, 1996 18:30 EDT +----------------------------------------------------------------------+ | GNAT is a complete Ada95 compilation system, maintained and | | distributed under the Gnu Public Licence by Ada Core Technologies. | | ACT and ACT-Europe offer commercial support for industrial | | and academic users of GNAT. | | | | For more info: | | - web site http://www.gnat.com | | - for description of ACT services, | | send empty e-mail to: info@gnat.com | | info@act-europe.gnat.com | | | | - detailed queries: support@gnat.com | | - Telephone 212-620-7300 Ext-117 (Nancy Cruz)| | - Fax 212-807-0162 | +----------------------------------------------------------------------+ Bug reports should be sent to report@gnat.com. Please remember to place your ACT customer number in the subject line to insure high priority response. Bug reports from unsupported users are welcome although we cannot guarantee a response. This is the README which is located on cs.nyu.edu in pub/gnat (via anonymous ftp). It contains information about recent distributions of GNAT. Followers of GNAT are encouraged to check this file often for news. This file may be obtained by sending email to: "gnat-send-readme@cs.nyu.edu". Checking this file is particularly important when encountering installation difficulties. News, workarounds, etc. are put in here so that everyone can benefit most quickly from the discoveries made as new versions propagate. The Installation Update News will always be near the top under UPDATE NEWS:: The pub/gnat directory contains recent releases of GNAT. It's contents are described below under CONTENTS:: Information pertaining to unpacking the various distributions follow below under: UNPACKING UNIX DISTRIBUTIONS:: UNPACKING Windows 95 / Windows NT DISTRIBUTIONS:: UNPACKING OS/2 DISTRIBUTIONS:: UNPACKING DOS DISTRIBUTIONS:: ================================================================= UPDATE NEWS:: Additional FTP sites which mirror the pub/gnat directory are listed later on under GNAT Mirror Sites. These sites are generally updated within 24 hours of changes at cs.nyu.edu. Distributed Systems Annex July 14, 1996 18:30 EDT Annoucing the first public release of DSA, the Ada 95 Distributed Systems Annex implementation for GNAT. DSA is an environment for developing distributed applications based on Annex E of the Ada 95 Reference Manual. This environment comprises: - a complete PCS (Partition Communication System) - a compiler for a simple partition description language - utilities to build and start distributed applications This first release works with GNAT 3.05 on Sparc/Solaris and PC/Linux. This release also works on Sparc/SunOS although less efficiently. The release can be found in the "dsa" directory. Versions for DEC/Digital Unix, HP/HP-UX, Windows NT and SGI/Irix will be available in the future. gnat 3.05 is now available Version 3.05 release: The binary distribution is now available for the following configurations: alpha-dec-osf3.2 (includes tasking) dos (includes tasking and uses djgpp 2.0) linux (ELF) mips-sgi-irix5.3 netbsd1.1 (for x86) nextstep3 (for x86) os2 powermac (for machten) rs6000-ibm-aix3.2 sparc-sun-solaris2.4 (will also run on solaris2.3 and solaris2.5) sparc-sun-sunos4.1.3 Distribution Update News: (version 3.05) All binaries are built on top of GCC 2.7.2. Source Distribution Update News (Version 3.05): GNAT 3.05 must be built on top of GCC 2.7.2 gnat-3.05-src-update.tar.gz powermac (for machten) binary installation: July 9, 1996 01:30 EDT The binary distribution for powermac running machten is now available in the powermac directory. Instructions for installing are given in the README files contained in that directory. i386-netbsd1.1 binary installation: June 18, 1996 23:30 EDT The binary distribution for netbsd1.1 is now available. The following two files make up the distribution: gnat-3.05-i386-unknown-netbsd1.1.README and gnat-3.05-i386-unknown-netbsd1.1.tar.gz. nextstep for x86 binary installation: July 7, 1996 23:30 EDT The binary distribution for nexstep3 on the x86 is now available as the file gnat-3.05-i386-next-nextstep3-bin.tar.gz Sparc Solaris 2.4 binary installation: June 11, 1996 23:00 EDT The binary distribution for Sparc Solaris 2.4 is now available in the file gnat-3.05-sparc-sun-solaris2.4-bin.tar.gz. Sun OS binary installation: June 11, 1996 23:00 EDT The binary distribution for Sparc SunOS 4.1.3 is now available in the file gnat-3.05-sparc-sun-sunos.4.1.3-bin.tar.gz. The following warning message during installation (doconfig option 3) should be ignored. ranlib: warning: libgthreads.a(io.o): no symbol table Alpha binary installation: June 11, 1996 23:00 EDT The binary distribution for Alpha OSF3.2 is now available in the file gnat-3.05-alpha-dec-osf3.2-bin.tar.gz. This includes a preliminary version of tasking. Note: When installed on top of an existing directory, tar may give peculiar error messages so it is advisable to delete the old directory first. SGI Irix 5.3 binary installation: June 11, 1996 23:00 EDT The binary distribution for SGI Irix 5.3 is now available in the file gnat-3.05-mips-sgi-irix5.3-bin.tar.gz. RS6000 binary installation: June 11, 1996 23:00 EDT The binary distribution for RS6000 AIX 3.2 is now available in the file gnat-3.05-rs6000-ibm-aix3.2-bin.tar.gz. DOS binary installation: June 12, 1996 15:00 EDT The binary distribution for DOS is now available. It now includes tasking and a fully functioning gnatmake. The DOS version uses the latest version of DJGPP (version 2.0) which handles virtual memory much more efficiently. Therefore the new version of DJGPP needs to be installed for GNAT 3.05. The file djgpp-2.00-dos-bin.zip contains what is required from the new DJGPP release. The following four additional files make up the distribution: gnat-3.05-dos-bin-disk[1234].zip. The DOS version is now packaged inside the ez2load directory. It may be installed using the ez2load installer which is simply to use or by following the directions given below under "UNPACKING DOS". The "ez2load" directory currently contains a nice development environment for GNAT under DOS including AdaCAPS and a windows IDE is available. The Lovelace Ada 95 tutuorial is also located there. Depending on the OS you are running under (NT, W95, DOS, or OS/2) and the version of unzip you are using, LIBGTHREADS.A might come out as LIBGTH~1.A or LIBGTHRE.A in the \DJGPP\LIB directory. If this happens, simply rename it to LIBGTHREADS.A or LIBGTHRE.A (depending on whether or not your OS supports long file names). OS/2 binary installation: June 12, 1996 18:00 EDT The binary distribution of GNAT 3.05 for OS/2 is now available. Please note that GNAT OS/2 now uses five diskettes rather than four; three for GNAT and two for EMX. Please read the unpacking instructions given below as well as the READ.ME and README.EMX files in the emx\gnat directory once the files are unpacked. Previous OS/2 users of GNAT are also advised to briefly check the unpacking instructions given below for any new details. Linux (ELF) binary installation: June 17, 1996 23:00 EDT The installation directions mention to get package binutils-2.6.0.2.bin.tar.gz from either sunite or tsx-11. Unfortunately these are no longer available at these sites so unless you already have these available it is necessary to retrieve from sunsite or tsx-11 the following pair instead: binutils-2.6.0.14.bin.tar.gz and libc-5.3.12.bin.tar.gz. If you get the later binutils (2.6.0.14) you must also get the later libc (5.3.12) as the newer binutils will not work properly with the old version of libc. June 11, 1996 23:00 EDT The GNAT 3.05 binary distribution for Linux elf format is now available in the file gnat-3.05-i486-linux-elf-bin.tar.gz. Its accompanying README is now included in the distribution along with an installation script. gnat 3.04 is now available Version 3.04 release: The binary distribution is now available for the following configurations: mac68k (for machten) Windows 95 and Windows NT for the Intel x86. Distribution Update News: (version 3.04) All binaries are built on top of GCC 2.7.2. Source Distribution Update News (Version 3.04): GNAT 3.04 must be built on top of GCC 2.7.2 mac68k (for machten) binary installation: July 9, 1996 01:30 EDT The binary distribution for mac68k running machten is now available in the mac68k directory. Instructions for installing are given in the README files contained in that directory. Windows 95/Windows NT binary installation: June 12, 1996 15:00 EDT The GNAT 3.04a1 binary distribution for Windows'95 and Windows NT (3.5 or above) on the PC is now available in the file setup_gnat3041a_win95.exe.gz. It supports tasking. It contains all the libraries you need to do Ada programming, but the libraries for direct calls to the Win32 API are available separately from LabTek (labtek@cs.yale.edu). See instructions below on unpacking the Windows 95/Windows NT version. This is the Labtek port of GNAT. General Installation notes for Unix installations: Note to users trying to install using option 1 only: Option 1 is a bit trickier now trying to graft GNAT onto GCC version 2.7.2. Users trying to install with option 1, that it trying to install GNAT on top of their existing GCC installation, on a system running SunOS 4.1 rather than 4.1.3 should make a link from sparc-sun-sunos4.1.3 to sparc-sun-sunos4.1 in their gcc-lib directory. If trying to install on top of a system running gcc 2.7.0 rather than 2.7.2 make a link running from 2.7.0 to 2.7.2 followed by the doinstall. Version 3.03 release: Distribution Update News: (version 3.03) All binaries are built on top of GCC 2.7.2. Source Distribution Update News (Version 3.03): GNAT 3.03 should be built on top of GCC 2.7.2 The binary distribution is now available for the following configurations: i386-sun-solaris2.4 (for x86) hppa HP PA binary installation: April 23, 1996 15:00 EDT The file gnat-3.03-hppa-bin.tar.gz representing the binary distribution for the HP PA-RISC architecture is now available. Solaris x86 binary installation: Jan 24, 1996 13:40 EST The GNAT 3.03 binary distribution for Solaris x86 is now available. The following two files make up the distribution: gnat-3.03-i386-unknown-solaris2.4-bin.tar.gz gnat-3.03-i386-unknown-solaris2.4-readme Version 3.01 release: The binary distribution is now available for the following configurations: linux (a.out) mips-dec-ultrix4.3 Linux (a.out) binary installation: Jan 5, 1996 00:30 EST The GNAT 3.01 binary distribution for Linux (a.out) is now available. The a.out version is available in the file gnat-3.01-linuxaout.tar.gz with an accompanying README in gnat-3.01-linuxaout.README. Decstation Ultrix binary installation: Dec 17, 1995 19:30 EST The binary distribution for Decstation Ultrix 4.3 is now available in the file gnat-3.01-mips-dec-ultrix4.3-bin.tar.gz. ----------------------------------------------------------------------------- Old source and binaries of GNAT have been moved to pub/gnat/private/old on cs.nyu.edu in order not to clutter up the main pub/gnat directory and not to be picked up by mirror sites. If for some reason you need to retrieve any of these old versions, that is where they can be found. OS/2 PM bindings: July 7, 1996 13:00 EDT The public release of the OS/2 bindings are now available in the contrib/os2/bindings subdirectory. This directory contains os2bnd04.zip and a README. Forest (Posix binding) bindings; June 12, 1996 18:00 EDT The public release of Forest version 1.4 is now available in the contrib/forest subdirectory. The 5.95 version of the reference manual for Ada95 is available under the directory rm9x-5.95. Since gnat 2.07 uses gcc version 2.7.0 the environment variables that are set as part of the binary installation need to reference 2.7.0 rather than 2.6.3 which was used previously. So for those using the doconfig script with option 3 make sure that the file env-vals created by the script is placed in your .cshrc and that it replaces any old one (with 2.6.3 references) that was there from a previous installation. The -gnatv option will indicate to you which version of gnat you are running. ========================================================================== Mirror Sites: US sites: ftp://ftp.cdrom.com/pub/languages/ada/compiler/gnat/distrib ftp://wuarchive.wustl.edu/languages/ada/compiler/gnat/distrib European sites: ftp://ftp.cs.kuleuven.ac.be/pub/Ada-Belgium/mirrors/gnu-ada ftp://ftp.dit.upm.es/mirror/cs.nyu.edu/pub/gnat ftp://ftp.cs.tu-berlin.de/pub/gnu/gnat ftp://ftp.cci.de/pub/Ada/gnat ftp://ftp.informatik.rwth-aachen.de/pub/mirror/cs.nyu.edu/pub/gnat ftp://ftp.ibp.fr/pub/gnat ftp://ftp.cnam.fr/pub/Ada/PAL/compiler/gnat/distrib ftp://ftp.eunet.no/pub/gnu/gnat ftp://ftp.fsz.bme.hu/pub/ada/gnat ftp://snowwhite.it.brighton.ac.uk/gnat Australia site: ftp://csc.canberra.edu.au/pub/ise/gnat ============================================================================ CONTENTS:: The contents of the pub/gnat directory are: This README file. The file "features" which lists the language features that are implemented in the lastest version of GNAT is located both in the pub/gnat directory and as part of each distribution. It is updated periodically to reflect new features put into the latest release. The subdirectory "docs" contains various documents about GNAT. The file "unz50x32.exe" is used for unpacking OS/2 zip files (more below). The file "unz511x.exe" is used for unpacking DOS zip files (more below). There are source and binary distributions both for sparc machines running SunOs 4.1 (these distribution files end in ".gz") and for OS/2 (these distribution files end in ".zip"). There are also binary distributions for other architectures/operating systems, including for example DOS and most recently Windows 95. Since the front end of GNAT is written in Ada, you need a running version of GNAT in order to build GNAT from the sources. Once you have GNAT running on your system, most releases can be built from previous ones. To get started initially (and when there are boostrap problems that will be documented here) you need to install GNAT from a binary distribution. We anticipate that many people will never have an interest in building GNAT, and will therefore simply pick up new binary distributions. Intructions for installing and running GNAT are in each distribution. The source distributions also contain instructions for building GNAT. Make sure that you transfer with ftp in binary mode. =============================================================================== UNPACKING UNIX DISTRIBUTIONS:: The Unix (specifically sparc) distributions need to be uncompressed with 'gunzip' (or equivalently 'gzip -d'), and then unpacked with tar. So the necessary commands would be something like the following for unpacking version GNAT 3.05 for the sparc solaris 2.4 version: gunzip gnat-3.05-sparc-sun-solaris2.4-bin.tar.gz tar xf gnat-3.05-sparc-sun-solaris2.4-bin.tar Here is the scoop on gunzip: Because the unix `compress' utility is patented (by two separate patents, in fact), we cannot use it; it's not free software. Therefore, the GNU Project has chosen a new compression utility, `gzip', which is free of any known software patents and which tends to compress better anyway. All compressed files in the GNU anonymous FTP area (prep.ai.mit.edu:/pub/gnu) have been converted to the new format. Files compressed with this new compression program end in `.gz' (as opposed to `compress'-compressed files, which end in `.Z'). Gzip can uncompress `compress'-compressed files and `pack' files (which end in `.z'). This is possible because the various decompression algorithms are not patented---only compression is. The gzip program is available from any GNU mirror site in shar, tar, or gzipped tar format (for those who already have a prior version of gzip and want faster data transmission). It works on virtually every Unix system, MSDOS, OS/2, and VMS. After doing this, check in the newly created GNAT distribution directory for further installation instructions. ------------------------------------------------------------------------------- UNPACKING Windows 95 / Windows NT DISTRIBUTIONS:: To install, use binary mode ftp and retrieve setup_gnat304a_win95.exe.gz and gzip.exe, then run "win95-gzip.exe" on it to decompress. Finally run the setup program which will guide you through the process. Note: This Windows 95/ Windows NT distribution of the GNAT Ada compiler for the Intel architecture is maintained by LabTek Corporation. For questions about the Win95/Winnt version send mail to labtek@cs.yale.edu. ------------------------------------------------------------------------------- UNPACKING OS/2 DISTRIBUTIONS:: The executables for the OS/2 version of GNAT are split into 5 files, each of which can fit on one 3.5-inch high-density diskette. Although it is possible to install GNAT on a FAT partition, such an installation will be somewhat limiting due to the restriction of 8 character filenames. But it is possible to run GNAT in this mode using the -gnatk8 option. Therefore, we recommend to install GNAT on an HPFS partition. If you don't have the unzip program, you can download the file unz50x32.exe, run it in an empty directory, and copy the file unzip.exe to a directory listed in your PATH environment variable. Please note that PKUNZIP will NOT work.) The executables for the OS/2 version of GNAT are contained in 5 zip files. They occupy about 13 megabytes when unzipped. The contents of each zip file are as follows (xx is the minor revision#): #1 gnat-3.xx-os2-bin-disk1.zip: #2 gnat-3.xx-os2-bin-disk2.zip: #3 gnat-3.xx-os2-bin-disk3.zip: The GNAT portion of the GNU compiler and utilities. GNAT runtime library. Documentation and examples. README.OS2. #4 emx09b-gnat-os2-bin-disk1.zip: #5 emx09b-gnat-os2-bin-disk2.zip: Minimal EMX installation including the GNU gcc driver, the C portion of the GNU compiler, assembler, linker, debugger, utilities, "C" runtime library, C include files, necessary DLLs and documentation. Important note for previous users of GNAT on EMX. ------------------------------------------------- Since you have already installed the EMX09a zip files while installing the previous GNAT release you need to remove the EMX subdirectory in order to prevent conflicts between EMX09A files and new EMX09b files that will be created during installation of GNAT 3.05. Once this is done just follow the regular instruction starting giving below in the paragraph starting with "To begin". Release 3.05 is based on EMX 9b (with fix01) which was based on GCC 2.7.2. To begin the installation copy the .zip files to the root of the partition on which you wish to install GNAT. Unzip them there using unzip.exe. Example (replace xx with the current GNAT minor version): >c: >cd \ >copy gnat-3.xx-os2-bin-disk1.zip . >copy gnat-3.xx-os2-bin-disk2.zip . >copy gnat-3.xx-os2-bin-disk3.zip . >copy emx09b-gnat-os2-bin-disk1.zip . >copy emx09b-gnat-os2-bin-disk2.zip . >unzip gnat-3.xx-os2-bin-disk1.zip . >unzip gnat-3.xx-os2-bin-disk2.zip . >unzip gnat-3.xx-os2-bin-disk3.zip . >unzip emx09b-gnat-os2-bin-disk1.zip . >unzip emx09b-gnat-os2-bin-disk2.zip . Once you've done the above, read and follow the directions in given in \EMX\GNAT\READ.ME to complete the installation. The file \EMX\GNAT\README.EMX (same as \EMX\README.EMX) explains about the minimal EMX system subset that is being distributed through the files emx09b-gnat-os2-bin-disk1.zip and emx09b-gnat-os2-bin-disk2.zip for support of GNAT. -------------------------------------------------------------------------- UNPACKING DOS DISTRIBUTIONS:: These instructions pertain to GNAT 3.04 and later. The file "unz511x.exe" is used for unpacking DOS zip files and is available in the ftp directory. You can also use the popular pkunzip.exe program if you already have it. Unz511x.exe is a self extracting archive. To use it you should create an empty, temporary directory, copy unz511x.exe into that directory and run it. (The reason for doing this is that it unzips itself and creates a number of auxiliary files which would clutter up an existing directory.) Once you have it unzipped, you should copy the unzip.exe executable to a directory listed in your PATH environment variable so that is can be run from the GNAT installation directory. The executables for the DOS version of GNAT are contained in 5 files. They occupy about 10 megabytes when unzipped. The contents of each zip file are as follows (where "xx" is the minor version number): #1 GNAT-3.xx-DOS-BIN-DISK1.ZIP: #2 GNAT-3.xx-DOS-BIN-DISK2.ZIP: #3 GNAT-3.xx-DOS-BIN-DISK3.ZIP: #4 GNAT-3.xx-DOS-BIN-DISK4.ZIP: GNAT and Gnu "C" compilers and utilities. GNAT runtime library. Documentation and examples. README.DOS. #5 DJGPP-2.00-DOS-BIN.ZIP: Minimal DJGPP installation including the go32 memory extender, 387 emulator, assembler, utilities, "C" runtime library and documentation. File #5 is required only if you don't already have the latest DJGPP release (version 2.0) installed . To begin the installation, create a directory called DJGPP on a drive with sufficient disk space. Copy the .zip files to this directory and unzip them using unzip.exe or a compatible program. The .zip files contain a complete directory tree, so if you use pkunzip be sure to include the -d switch. Example: >MKDIR C:\DJGPP >COPY GNAT-3.xx-DOS-BIN-DISK1.ZIP C:\DJGPP >COPY GNAT-3.xx-DOS-BIN-DISK2.ZIP C:\DJGPP >COPY GNAT-3.xx-DOS-BIN-DISK3.ZIP C:\DJGPP >COPY GNAT-3.xx-DOS-BIN-DISK4.ZIP C:\DJGPP >COPY DJGPP-2.00-DOS-BIN.ZIP C:\DJGPP >C: >CD \DJGPP >UNZIP GNAT-3.xx-DOS-BIN-DISK1.ZIP >UNZIP GNAT-3.xx-DOS-BIN-DISK2.ZIP >UNZIP GNAT-3.xx-DOS-BIN-DISK3.ZIP >UNZIP GNAT-3.xx-DOS-BIN-DISK4.ZIP >UNZIP DJGPP-2.00-DOS-BIN.ZIP or >PKUNZIP -D GNAT-3.xx-DOS-BIN-DISK1.ZIP >PKUNZIP -D GNAT-3.xx-DOS-BIN-DISK2.ZIP >PKUNZIP -D GNAT-3.xx-DOS-BIN-DISK3.ZIP >PKUNZIP -D GNAT-3.xx-DOS-BIN-DISK4.ZIP >PKUNZIP -D DJGPP-2.00-DOS-BIN.ZIP Once you've done the above, read and follow the directions in C:\DJGPP\README.DOS to complete the installation. Be sure to also read the DJGPP readme files: README.1ST and README.DJ. UNPACKING THE GNAT SOURCES -------------------------- The GNAT sources are distributed in two formats, one using gzip and the other using zip. The gzip format appears as gnat-3.xx-src.tar.gz (where xx is the minor release number). To unpack just use gunzip and then tar to extract. The zip format appears as three zip files: gnat-3.xx-src-disk1.zip, gnat-3.xx-src-disk2.zip and gnat-3.xx-src-disk3.zip. To see which unzip utility to use in unpacking these two zip files, see the instructions given in the sections above called UNPACKING DOS DISTRIBUTIONS or UNPACKING OS/2 DISTRIBUTIONS whichever is appropriate.